home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / tbag / tb044.dms / tb044.adf / Docs / vbhi.docs < prev    next >
Text File  |  1990-06-07  |  9KB  |  212 lines
  1.  ;***This program is freely distributable as long as the
  2. Archive contains this DOC file,the Arp.library, the text file
  3. scrollme.txt and the actual Program VBHI.
  4. This material is the property of L & V Productions.
  5.  
  6. BEGIN DOC FILE:
  7.  
  8. VBHI is a very flexible and easy to use TEXT SCROLL program.
  9. Its primary use is as a GENLOCKED TEXT SCROLLER.
  10. If you want to put Hi-Res characters, read in from an external
  11. Text file, onto the Amiga screen, this is the easy way to do it.
  12.  
  13. This version of VBHI is a fully working version of the Commercial
  14. product minus a few features.($29.99 U.S.)
  15. VBHI will read Text in from an ASCII file. It will also read in a
  16. file in Binary format and strip off the unecessary codes. The
  17. MAXIMUM Text file size for this release is 100,000 bytes. 
  18.  
  19. **REQUIRES**
  20. AMIGA 500 or 1000 or 2000 with 1MEG and 1 Floppy.(1.3 WB)
  21. 380,000 CHIP MEMORY & 300,000 FAST MEMORY FREE!
  22. Arp.library in your currently ASSIGNed libs: directory
  23.  
  24.  
  25. The included file Arp.Library must be in your libs directory.
  26. If you do not want to write onto your BOOT disk to try this program
  27. then read the following instructions.
  28. Open a CLI window and type:
  29.  
  30. makedir ram:libs
  31. copy sys:libs ram:libs all
  32. copy df0:Arp.library ram:libs
  33. assign libs: ram:libs
  34.  
  35.  
  36. The above series of CLI commands assumes the file Arp.library
  37. is in the Root directory on a disk in drive DF0:. Please adjust
  38. this as necessary. Remember this only stays in effect until you
  39. REBOOT your machine. 
  40.  
  41. To start VBHI simply double-click on its ICON or open a CLI window
  42. and type   VBHI . A file requester will appear asking you to select
  43. the TEXT file you wish to SCROLL. Select the File  "scrollme.txt" if 
  44. you do not have any Text files on your Disk.
  45. In a moment a Second, identical file requester will appear prompting
  46. you to select the FONT you wish to use. Here you use the File Requester
  47. to go into your currently assigned FONTS directory. Once you get
  48. there go right into the actual directory of the Font you want to use.
  49. For example if you wanted DIAMOND 15, you would enter the DIAMOND 
  50. directory and double click on the file   15   (MAX SIZE=72).
  51.  
  52. At this point you will notice 3 gadgets at the bottom of the window.
  53. ONLY! the one labelled "Shadow Depth" is live. Click once in the
  54. gadget with the Left Mouse button to activate the gadget. Now
  55. enter a number between 1-9. This is the amount of shadow depth given
  56. to the Cast shadow expressed directly in pixels. You do not have to
  57. press return. You may hear your disk drive grind if the selected font
  58. must be loaded from one of your drives. 
  59.  
  60.  
  61. The screen will now BLANK and there will be a short delay as your
  62. selected TEXT file is sorted into a Table by Lines with AUTO Wordwrap
  63. and Centering. This will take 5-8 seconds on a small file depending
  64. on the Font size selected.(be patient). While the processing is going
  65. on the screen and the mouse cursor will cycle through the Amigas color
  66. palett. When this stops you are ready to proceed!
  67. Presently the Screen will fill with Text and when you are now ready to
  68. begin scrolling, simply press the RETURN key.
  69. **NOTE** If there is no TEXT on the screen you have probably selected
  70. a Large font and you MUST press the RETURN key to scroll by the first
  71. screen which is probably just blank lines or carraige returns.
  72.  
  73.  
  74. The following Mouse and Keyboard Commands are now available to you.
  75.  
  76. Right Mouse Button    -Increases Scroll Speed
  77. Left  Mouse Button    -Decreases Scroll Speed
  78. SPACEBAR (key)        -Pause Scrolling
  79. RETURN     (key)        -Start Scrolling
  80. S     (key)        -Speed scrolling x 2 times
  81. B     (key)        -Go back to Start of Text file
  82. ESC      (key)        -Escape and QUIT program(hold key down)
  83. 1    (key)        -GOTO Start + 10%(LEFT OUT THIS PD VERSION)
  84. 2    (key)        -GOTO Start + 20%(LEFT OUT THIS PD VERSION)
  85. 3    (key)        -GOTO Start + 30%(LEFT OUT THIS PD VERSION)
  86. 4    (key)        -GOTO Start + 40%(LEFT OUT THIS PD VERSION)
  87. 5    (key)        -GOTO Start + 50%(LEFT OUT THIS PD VERSION)
  88. 6    (key)        -GOTO Start + 60%(LEFT OUT THIS PD VERSION)
  89. 7    (key)        -GOTO Start + 70%(LEFT OUT THIS PD VERSION)
  90. 8    (key)        -GOTO Start + 80%(LEFT OUT THIS PD VERSION)
  91. 9    (key)        -GOTO Start + 90%(LEFT OUT THIS PD VERSION)
  92.  
  93.  
  94. Once you get to the end of your selected Text file the program will
  95. scroll the final 3 screens in a loop until you either:
  96. 1.    Press the "SPACEBAR"(key) to enter PAUSE MODE.
  97. 2.    Press the "B"(key) to Backup to the Start of the File.
  98. 3.    Press the "ESC"(key) to QUIT the program.
  99.  
  100. Really, that is about it for this PUBLIC DOMAIN version. I wanted
  101. to release a functional version so that it could be used right
  102. away. I also wanted to entice you to buy the Commercial version which
  103. contains the following additions to this program.
  104.  
  105. 1.    Selection of Face and Shadow color.
  106. 2.    Selection of Shadow depth & type.
  107. 3.    Selection of Line Spacing values.
  108. 4.    Text Justification -Center - Left - Right
  109. 5.    Ability to GOTO 10 preset positions.
  110.     in your Text file instantly.
  111. 6.    Additional Scrolling speeds.
  112. 7.    Teleprompter Setup.
  113. 8.    Select Fonts from any Directory or Disk.
  114. 9.    Select all UPPER, or lower Case text.
  115. 10.    General Bug cleanup
  116.  
  117.  
  118.     RETAIL PRICE $29.99 U.S. (Shipped VIA Mail)
  119.  
  120. I obviously had to compromise to be able to release this to the
  121. Public Domain. So I left out all of the Intuition stuff that makes
  122. life easier and the program more Logical and Intuitive to use. Also I
  123. left out the items in the above mentioned list of features of the
  124. Commercial version. But hey!, this is FREE, just what did you expect?
  125.  
  126.  
  127. **UPCOMING
  128. This program curently supports 4 bitplanes(16 colors). I will
  129. add COLORFONT support shortly or I might just wait for
  130. Workbench 2.0 where Colorfont Support will be built in the OS.
  131.  
  132.  
  133. Either/both Prowrite and Pagesetter-Pro Page will be supported
  134. in their native file formats. This means support for MULTI-COLUMN
  135. documents, with MULTIPLE FONTS in Bold, Italics, Underline etc.
  136.  
  137. Same program but in PAGE-FLIPPING mode. Flipping tied to timed-events
  138. and/or Mouse/Keyboard events.
  139.  
  140.  
  141. **BUGS,RUMOURS, etc.
  142.  
  143. After running VBHI 7 times in a row, the program redraws the first screen
  144. twice before you start. The next time(8th) you try to run VBHI the 
  145. program will go as far as Font Selection and then will quit. This is
  146. Interrupt server and "SIGNAL"problem I am looking into. SOLUTION->REBOOT!!
  147.  
  148. When run from the CLI, VBHI does not return control to the CLI window.
  149. You must Click once with the left mouse button on any other Window
  150. or Screen. You then can click back into the CLI Window to make it
  151. active. Sorry, I play with some IntuitionBase values that seem to
  152. cause this problem. I'm working on it.
  153.  
  154.  
  155.  
  156. **HINTS, TIPS
  157. Since this PD version does not allow you to change the LINE SPACING 
  158. variable,  the following info may be helpful.
  159.  To figure out the amount of lines per screen in your Currently
  160. selected FONT:
  161. ie.    40  point Font
  162.     10  25% original Font height(BUILT IN PERCENTAGE)
  163.     4   Shadow depth
  164.     --
  165.     64 =Line spacing
  166.  
  167. So 400/64 = 6 lines per screen. There are other Factors to consider
  168. (descenders etc.) but this will give you a good value to work with.
  169. By altering the number of CR's between lines of text you can indirectly
  170. affect the Line Spacing.
  171.  
  172. You can use Fonts up to 89 points in size, though my error checking
  173. stops at 72 points.
  174.  
  175. Remember the Fonts you want to use MUST be in the currently assigned
  176. FONTS directory. Open a CLI window and type "ASSIGN" to see the
  177. current assignment. I have the FONT FILE REQUESTER default to 
  178. SYS:FONTS, so if you have re-ASSIGNED the FONTS directory to another
  179. DISK,(or conversely the SYS:) you MUST use the File Requester 
  180. to go directly into your new Assigned FONTS location.
  181. The Commercial release will use the ARP's library "ASSIGN" routine
  182. to allow you to pick your Font from anywhere. I can't wait to get
  183. Workbench 2.0 so this problem will be a thing of the past!
  184.  
  185. For those of you not familiar with the ARP File Requester I suggest
  186. you spend a few minutes getting aquainted with its features. Once
  187. the Requester is active, if you CLICK on its DRAG BAR(at the top
  188. of the Requester), with your RIGHT mouse button, a LIST of the
  189. attached System devices appears in the File Selection Window.
  190. This enables you to easily jump from Disk or device to wherever
  191. your little heart desires. Thanks to the people behind ARP!
  192.  
  193.  
  194. I just noticed the Logic does not handle point sizes under 10. Will
  195. fix in Commercial release.
  196.  
  197. Please feel free to report any bugs/suggestions to:
  198.  
  199. Stephen Lebans
  200. PLINK   SLEBANS
  201.  
  202.  
  203. Please send Money Order or Cheque or 
  204. Fax Registered Company Purchase Order's to:
  205.  
  206. L & V Productions
  207. 110 Columbus Ave
  208. Moncton, New Brunswick
  209. Canada   E1A-5E4    
  210. PHONE:    (506)-532-0094
  211. FAX:    (506)-859-2709
  212.